Resource URL: /platform/<<version=3>>/fsa/results/<ID>/histogram/<STAT>

    Overview: Retrieve a file count histogram according to the STAT parameter.

     Methods: GET

********************************************************************************

Method GET: This resource retrieves a histogram of file counts for an
            individual FSA result set. ID in the resource path is the result
            set ID.

       URL: GET /platform/<<version=3>>/fsa/results/<ID>/histogram/<STAT>

Query arguments:
 directory_filter=<string> Filter according to a specific directory, which
                           includes all of its subdirectories.
 attribute_filter=<string> Filter according to the name of a file user
                           attribute.
 node_pool_filter=<string> Filter according to the name of a node pool, which
                           is a set of disk pools that belong to nodes of the
                           same equivalence class.
 disk_pool_filter=<string> Filter according to the name of a disk pool, which
                           is a set of drives that represent an independent
                           failure domain.
      tier_filter=<string> Filter according to the name of a storage tier,
                           which is a user-created set of node pools.
     comp_report=<integer> Result set identifier for comparison of database
                           results.
 log_size_filter=<integer> Filter according to file logical size, where the
                           filter value specifies the lower bound in bytes to a
                           set of files that have been grouped by logical size.
                           The list of valid log_size filter values may be
                           found by performing a histogram breakout by log_size
                           and viewing the resulting key values.
phys_size_filter=<integer> Filter according to file physical size, where the
                           filter value specifies the lower bound in bytes to a
                           set of files that have been grouped by physical
                           size. The list of valid phys_size filter values may
                           be found by performing a histogram breakout by
                           phys_size and viewing the resulting key values.
  path_ext_filter=<string> Filter according to the name of a single file
                           extension.
    ctime_filter=<integer> Filter according to file modified time, where the
                           filter value specifies a negative number of seconds
                           representing a time before the begin time of the
                           report. The list of valid ctime filter values may be
                           found by performing a histogram breakout by ctime
                           and viewing the resulting key values.
    atime_filter=<integer> Filter according to file accessed time, where the
                           filter value specifies a negative number of seconds
                           representing a time before the begin time of the
                           report. The list of valid atime filter values may be
                           found by performing a histogram breakout by atime
                           and viewing the resulting key values.

GET response body schema:
{
  "type": [
    {
      "additionalProperties": false, 
      "type": "object", 
      "description": "A list of errors that may be returned.", 
      "properties": {
        "errors": {
          "items": {
            "additionalProperties": false, 
            "type": "object", 
            "description": "An object describing a single error.", 
            "properties": {
              "field": {
                "type": "string", 
                "description": "The field with the error if applicable."
              }, 
              "message": {
                "type": "string", 
                "description": "The error message."
              }, 
              "code": {
                "type": "string", 
                "description": "The error code."
              }
            }
          }, 
          "type": "array"
        }
      }
    }, 
    {
      "type": "object", 
      "properties": {
        "atime_enabled": {
          "required": true, 
          "type": "boolean", 
          "description": "Access time enabled."
        }, 
        "histogram": {
          "items": {
            "type": "object", 
            "properties": {
              "bucket": {
                "required": true, 
                "type": "integer", 
                "description": "Bucket for holding file counts within a range."
              }, 
              "value": {
                "required": true, 
                "type": "integer", 
                "description": "Number of files within the bucket."
              }
            }
          }, 
          "required": true, 
          "type": "array", 
          "description": "Histogram data of specified file count parameter."
        }, 
        "attribute_count": {
          "required": true, 
          "type": "integer", 
          "description": "User attribute count."
        }, 
        "begin_time": {
          "required": true, 
          "type": "integer", 
          "description": "Unix Epoch time of start of results collection job."
        }
      }
    }
  ]
}
